Routines (alphabetical) > Routines: H > HDF-EOS Routines > EOS_PT_ATTACH

EOS_PT_ATTACH

This function attaches to the point using the pointname parameter as the identifier.

Syntax

Result = EOS_PT_ATTACH(fid, pointname)

Return Value

Returns the point handle (pointID) if successful and FAIL (–1) otherwise.Typical reasons for failure are an improper point file id or point name.

Arguments

fid

Point file id (long) returned by EOS_PT_OPEN.

pointname

Name of point (string) to be attached.

Keywords

None

Examples

In this example, we attach to the previously created point, “ExamplePoint”, within the HDF file, PointFile.hdf, referred to by the handle, fid:

pointID = EOS_PT_ATTACH(fid, "ExamplePoint")

The point can then be referenced by subsequent routines using the handle, pointID.

Version History

 

5.2

Introduced

See Also

EOS_PT_DETACH